ZPlay::LoadFileID3 Method

Load ID3 data from specified file. (ANSI version)

C++

bool LoadFileID3(System::String ^ FileName, TStreamFormat Format, TID3Version Id3Version, TID3Info % Info);

Parameters

Parameters	Description
System::String ^ FileName	String that specifies the name of the file.
TStreamFormat Format	Stream format. Use sfAutodetect if you need to autodetect stream format of specified file.
TID3Version Id3Version	ID3 version. Note: This value is only used for sfMp3 stream format. For all other stream formats this parameter is ignored.
TID3Info % Info	Reference to TID3Info receiving ID3 data.

Return Values

Return Values	Description
True	All OK.
False	Error. To get error message read here.

Remarks

Check supported formats for info tag support. Some formats can support some sort of "Info tags", but not all.

libZPlay library implements "ID3 tag" interface to different info tags (VORBIS comment, RIFF Info, ...). So, you can retrieve ID3 informations from different streams (mp3, ogg, flac, wav) because library will convert "format specific tag" to ID3 tag info.

Note: Use this function if you just need ID3 data and you don't need to play this file. This function only loads ID3 data. There is no checking if this is valid file, wave output isn't open ... This function has no effect on currently open file or stream.